home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / dev / misc / rcs_56.readme < prev    next >
Text File  |  1993-02-25  |  5KB  |  119 lines
  1. Short: RCS - Revision Control System Version 5.6
  2.           
  3.           *********************************
  4.           RCS - The Revision Control System
  5.           *********************************
  6.           
  7. ------------
  8. What is RCS?
  9. ------------
  10. RCS is a set of tools which help you to maintain version control
  11. over files. RCS was originally intended for software source code,
  12. but it now can handle binary files as well. The various programs
  13. let you check in new revisions, checkout current or previous
  14. revisions, review revision histories, etc.
  15.  
  16. RCS was developed originally at Purdue University by Walter Tichy.
  17. It is intended mainly for Unix machines, but the function it
  18. performs is really vital for any software development environment.
  19.  
  20. For a good introduction to RCS, read the article by Bryce Nesbitt
  21. in the last issue of Amiga World Tech Journal (RIP). The rcsintro.doc
  22. file (in this archive) also shows some examples.
  23.  
  24. ------------
  25. This Version
  26. ------------
  27. This is the AMIGA port of version 5.6 of RCS, which I believe is the
  28. latest (the one that was on the Amiga World Tech Disk was 4.3).
  29. This version has several enhancements over the previous Amiga
  30. ports - see the RCS.README file. For the Amiga, I've added wildcard
  31. expansion. However, two items which the Amiga port does not use:
  32.  
  33. - GMT times - RCS normally logs the GMT time rather than the local
  34.   time for across-timezone coordination. I originally had this in
  35.   but it requires keeping timezone information in an environment
  36.   variable referenced by every commmand. This didn't seem worth it
  37.   so I reverted back to local time. I can put GMT back in if anyone
  38.   cares.
  39.   
  40. - Links - Although both AmigaDOS 2.0 and RCS support links, this port
  41.   does not handle links any differently than any other file. This is
  42.   mainly because most of the Unix-like link support / resolution 
  43.   routines are present in DICE or SAS yet, and I'm too lazy to come
  44.   up with my own. I'm sure something will change there - Either I will
  45.   not be so lazy, or DICE and SAS will put them in. (Actually, DICE
  46.   does have a start on this already).
  47.  
  48. ------------
  49. Requirements
  50. ------------
  51. This version of RCS requires AmigaDOS 2.0 or later. If you try to
  52. run it under an earlier version, you should just get an error
  53. message, and the program will exit.
  54.  
  55. ------------
  56. Installation
  57. ------------
  58. Just put everything in the bin directory here somewhere in your
  59. path. Put the doc files where ever you like. Note that many of the
  60. programs run the 'diff' program - so diff needs to also be some-
  61. where on your path. This is the latest diff from GNU (1.15) so
  62. is a pretty handy program by itself. Sorry, I don't have a man
  63. page for diff.
  64.  
  65. To use most of RCS, you need to set either LOGNAME or USER environ-
  66. ment variable to the your name (or whatever name you want RCS to
  67. long into the revision history). Example:
  68.  
  69.               setenv LOGNAME SNEVL
  70.  
  71. NOTE: You can copy env:LOGNAME to envarc:LOGNAME and it will be
  72. set for you automatically everytime you boot.
  73.  
  74. All of the executables are pure, so you can make them resident if
  75. you wish.
  76.  
  77. --------------
  78. rcsfreeze.rexx
  79. --------------
  80. This is an ARexx script I wrote to go along with the RCS programs.
  81. On Unix systems there is a shell script called 'rcsfreeze' which
  82. does the same thing. This script assigns a symbolic name to the
  83. current checked-in version of every file in the current directory.
  84. This lets you later recreate that exact baseline using only that
  85. symbolic name, even though all the files may have had different
  86. version numbers. If all of that doesn't make sense to you yet,
  87. wait 'til you work with RCS a while.
  88.  
  89. ------------
  90. Distribution
  91. ------------
  92. RCS is free software, distributed under the GNU Public License
  93. (GPL) from the Free Software Foundation. See the file COPYING for
  94. details of the GPL. The important things to note are: (1) There
  95. is no warranty for RCS, by me or FSF; (2) RCS is free; you can
  96. distribute it all you want (and you are encouraged to) but you
  97. can not charge except to recover your costs associated with the
  98. distribution; (3) I have not included the source code, but the
  99. source code is available from me. If you want it, send me a floppy
  100. and enough postage to return it to you. The source builds under
  101. either DICE (2.06.40) or SAS/C (5.10b).
  102.  
  103. ----------------------
  104. Bugs / Requests / Etc.
  105. ----------------------
  106. If you find a problem with any of the RCS stuff, report it to me
  107. as soon as you can. DO NOT report the problem to the Free Software
  108. Foundation. If there is a bug, it's probably from me. Even if you
  109. want to request a change or just say hi, I'd be happy to hear
  110. from you. If you want to request the source, you'll need to mail
  111. your disk to me. Otherwise, you can get ahold of me via EMail.
  112.  
  113.  
  114. Steve Anderson                 BIX:        snevl
  115. 1136 11th Street               Compuserve: 74375,1514
  116. Manhattan Beach, CA 90266      Genie:      S.ANDERSON11
  117.  
  118. I'm also on the AmigaSerV BBS from time to time: 310-983-1600 
  119.